home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / morgl100.zip / MORGUL.DOC < prev    next >
Text File  |  1994-07-30  |  33KB  |  566 lines

  1. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  @F9
  2. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  3. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒┌──────────────────────────────────────────────────────┐▒▒▒▒▒▒▒▒▒▒
  4. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│Morgul 1.00 Online Help Documentation                 │░▒▒▒▒▒▒▒▒▒
  5. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│                                                      │░▒▒▒▒▒▒▒▒▒
  6. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│Keep this file in your path or in the directory where │░▒▒▒▒▒▒▒▒▒
  7. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you start Morgul from. In Morgul you can access this  │░▒▒▒▒▒▒▒▒▒
  8. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│file by pressing Alt-H. If this file is not found,    │░▒▒▒▒▒▒▒▒▒
  9. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│you will only get the quick help screen.              │░▒▒▒▒▒▒▒▒▒
  10. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│If you read this document with an external ascii      │░▒▒▒▒▒▒▒▒▒
  11. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│viewer or editor, please set line wrapping off so that│░▒▒▒▒▒▒▒▒▒
  12. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│the control codes outside the screen will not become  │░▒▒▒▒▒▒▒▒▒
  13. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒│visible. That way this document looks much cleaner.   │░▒▒▒▒▒▒▒▒▒
  14. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒└──────────────────────────────────────────────────────┘░▒▒▒▒▒▒▒▒▒
  15. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒▒▒▒▒▒▒▒
  16. ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  17.                                                                                   @A0
  18.                                  Introduction                                     @Z1Introduction
  19.                                  ------------                                     @A0
  20.  
  21.     The Morgul Player is a music module file player, which plays most
  22.     music module formats on all popular sound devices. The sound output
  23.     system is DSMI, which allows for lots of features and flexibility.
  24.  
  25.     Morgul is free software, which means you can copy it to your
  26.     friends, upload it to BBS's and FTP sites, and distribute in other
  27.     similar ways as long as no money is involved. If you find yourself
  28.     using this program, you are asked to send me a postcard. My mail
  29.     address can be found at the end of this file.
  30.  
  31.     Currently the following popular sound cards and their compatibles
  32.     are supported:
  33.  
  34.         1 Sound Blaster                                                           @F0
  35.         2 Sound Blaster Pro
  36.         3 PAS+
  37.         4 PAS16
  38.         5 SB16
  39.         6 general DAC (Covox)
  40.         7 Aria cards, like Audiobahn
  41.         8 Windows Sound System & compatibles, like AudioTrix Pro and
  42.           Compaq BusinessAudio
  43.         9 Gravis Ultrasound and Gus MAX
  44.         10 PC Speaker
  45.         11 Stereo DAC (LPT1 & 2)
  46.         12 Stereo-on-1 DAC
  47.                                                                                   @A0
  48.  
  49.             The following module formats are currently supported:
  50.  
  51.     MOD,NST     Sound/Noise/Pro/Fast/TakeTracker,PT4Gus and so on, also           @F0
  52.                 reverse file names (MOD.* NST.*) are supported.
  53.     STM         Scream Tracker 2.x 4 channel files
  54.     S3M         Scream Tracker 3 1-16 channel files (AdLib channels not
  55.                 supported)
  56.     MTM         MultiTracker 1-32 channel files
  57.     FAR         Farandole Tracker 16-channel files
  58.     669         669 Composer 8-channel files
  59.     AMF         Special module format which only DSMI players can play.
  60.                 Other modules converted to this format will be smaller
  61.                 than the originals.
  62.                                                                                   @A0
  63.  
  64.     What separates Morgul from other players is the advanced file
  65.     manager where you can choose files using the arrow keys or tag
  66.     several files into play queues. All common archive formats are
  67.     supported, and the archives are searched for module files which can
  68.     then be played like any other modules. Morgul takes care of calling
  69.     the unarchiver. Archive formats currently supported are
  70.     ARJ,ZIP,LZH/LHA,SQZ,RAR and UC2.
  71.  
  72.     For playing the larger modules, Morgul can take advantage of EMS
  73.     memory, loading the instruments into EMS.
  74.  
  75.     Digital, user-definable effects makes modules sound even better than
  76.     they used to! For example, Hall Reverb can make modules sound like
  77.     they were played in a big hall. Currently available effect types are
  78.     reverb and filter.
  79.  
  80.     Because of advanced mixing techniques, the sound quality is
  81.     generally better on 8-bit cards than with other players, and Morgul
  82.     is one of the few players to take advantage of the extra sound
  83.     quality offered by the 16-bit sound cards.
  84.  
  85.     Because Morgul is very feature-rich, there is a quick help screen, a
  86.     command menu, and online documentation (which is actually this
  87.     file). These can help you take full advantage of Morgul's
  88.     capabilities.
  89.  
  90.     Morgul can be configured to your tastes by using the configuration
  91.     file Morgul.cfg. All command line switches can be put to the MORGUL
  92.     environment variable so you don't have to type them over and over
  93.     again.
  94.  
  95.     You can try out and play the samples in the modules and then save
  96.     them in raw or Scream Tracker 3 formats. Support for GUS patches and
  97.     WAV files is coming, as well as signed raw files.
  98.  
  99.     In the DOS Shell, you can change the master volume and position of
  100.     the module which is currently playing using the shell hotkeys + and
  101.     - on the numeric keypad, accompanied with Alt or Control.
  102.  
  103.                             Requirements                                          @Z2Requirements
  104.                             ------------                                          @A0
  105.  
  106.     386 compatible processor. If you have a 486, Morgul will use some
  107.     486-specific optimizations for more speed.
  108.     VGA-compatible display adapter. EGA adapters work partially.
  109.  
  110.     Mouse and soundcard optional (although a soundcard is highly
  111.     recommended, the internal speaker doesn't sound too good. If you
  112.     can't afford a soundcard, build a "Covox" device which is a simple
  113.     DAC in the printer port.)
  114.     If you want real sound quality, get a Gravis Ultrasound board.                @C0
  115.     (This little advertisement is not funded by Advanced Gravis,                  @A0
  116.     although it certainly would not hurt me if it was :)
  117.  
  118.  
  119.  
  120.                             Possible bugs                                         @F0
  121.                                                                                   @A0
  122.  
  123.     As some of my pre-public beta stage testers have mostly been lazy,
  124.     testing under different situations is not perfect. Some of the bug
  125.     reports I receive are just about as useful as "Hi! Your program
  126.     crashes on me." Also, DSMI seems to have a couple of small bugs. All
  127.     comments and bug reports are very welcome! See the contact methods
  128.     near the end of this document. If you do a bug report, please report
  129.     at least the following:
  130.  
  131.     Operating system and version (type ver /r and give all the info it
  132.     gives), What memory manager and what version of it you were running,
  133.     if any, your config.sys and autoexec.bat contents, what machine you
  134.     have (processor, chipset, bios, video adapter), the sound board you
  135.     are using, including version numbers and everything, specific
  136.     instructions for reproducing the error situation: Telling "Well I
  137.     started it and soon it crashed." won't help me to find the bug, but
  138.     if you tell the directory and path you were in, how and with what
  139.     parameters Morgul was started with, the contents of the Set Morgul
  140.     environment variable, the contents of the config file (you can leave
  141.     out the comment lines to reduce bug report size ;) and what you did
  142.     inside Morgul, and if you shelled, what software and commands you
  143.     ran. All error messages are important!
  144.  
  145.  
  146.  
  147.                             Instructions                                          @Z4Instructions
  148.                             ------------                                          @A0
  149.  
  150.     Note: If you find it hard to learn all the keys, just remember this
  151.     one: Alt-M. It will bring up a menu of functions and also shows the
  152.     keys for each function.
  153.  
  154.                       The file system and startup                                 @F0
  155.                                                                                   @A0
  156.     When the Morgul starts up, it loads the current directory, searching
  157.     for module files. When that's done, the file selection screen shows
  158.     up. Here you can move up and down in the file list with the cursor
  159.     keys and tag files for playing with space or enter.
  160.  
  161.     When you tag your first file, Morgul loads it immediately and starts
  162.     playing it. When you tag more files, they will be added in the
  163.     playing list, so that when you press N or the currently playing
  164.     module ends, it will go automatically for the next file and play
  165.     that. When all files are played, it will go back to the beginning.
  166.     If you have Random mode on (achieved by pressing ALT-R or using
  167.     cmdline/environment parameter -o, or the config file), Morgul will
  168.     play the tagged files in random order.
  169.  
  170.     In few situations an advanced system like this may be actually in
  171.     the way; If so, use the Easy mode. This can be toggled with Alt-E or
  172.     the -e environment/command line parameter. This works
  173.     instantaneously.
  174.  
  175.     Because of it's features, Morgul is a good "demo" program for people
  176.     who run soundcard demostrations on their machines. They can tag
  177.     several good module files and let it play through them all over and
  178.     over again, without having to worry about either the player
  179.     repeating the same thing all the time or changing the module
  180.     themselves. If you use Morgul for this kind of purposes, you must
  181.     send me a postcard from your company, in which you tell me exactly
  182.     how you use the program, and what kind of company you run, and
  183.     possibly other information. (You're also welcome to send me any
  184.     samples of the hardware you sell, I'm always open for bribes :)
  185.  
  186.                         Archive support                                           @F0
  187.                                                                                   @A0
  188.     Morgul needs the correct unpackers if you wish to play modules from
  189.     archives. The unpackers are searched from the path, with these
  190.     filenames: ARJ.EXE, PKUNZIP.EXE, LHA.EXE, SQZ.EXE, RAR.EXE and
  191.     UC.EXE. If these are not found, you will receive a "File error"
  192.     message when playing archived modules.
  193.     The modules are extracted to a temp directory pointed to by the SET
  194.     TEMP environment variable. If TEMP is not found, TMP is used, and if
  195.     that is not found, the current directory will be used. It is
  196.     recommended you point TEMP to a fast hard drive or a ramdisk.
  197.  
  198.     Note: Even for READING UC2 files, you will need UC.EXE in your path,
  199.     because the only possible way for third-party developers supporting
  200.     UC2 to read the file contents is to execute UC.EXE with a special
  201.     parameter and then read it's output. This is because even the
  202.     directory structure of an UC2 archive is compressed! Also, to play
  203.     UC2'ed files, you will probably run out of memory because UC2 needs
  204.     lots of memory. If you experience this, you can use UltraStealth.
  205.     Install UltraStealth into your autoexec.bat file (add C:\UC\US.EXE
  206.     to the end of autoexec.bat) and enable UltraStealth from the Morgul
  207.     config file by setting UltraStealth=On.
  208.  
  209.  
  210.                        The multiple screens                                       @F0
  211.                                                                                   @A0
  212.     The Morgul consists of 3 different screens (somebody calls them
  213.     "virtual screens".) The middle one is the default one which you see
  214.     at the startup: It has the file selector system. The other two ones
  215.     are the top and bottom screen. You can scroll between them with Page
  216.     Up and Page Down keys, or by pressing Alt-1, Alt-2, Alt-3 or Alt-4.
  217.     You can also change the default startup screen with the cmdline/
  218.     environment parameter -r[1,2,3,4] or in the config file.
  219.  
  220.     The topmost screen is the most interesting one. Here you can see the
  221.     instrument names, volume bars, and other information about the
  222.     currently playing module file. It is also possible to do different
  223.     operations from here. You can play the instruments of the module
  224.     YOURSELF on the keyboard! Open extra channels for yourself with the
  225.     Ctrl-left and Ctrl-Right keys, then press TAB and you can move
  226.     around in the instrument list with the cursor keys.
  227.  
  228.                     2 3   5 6 7   9 0                                             @F0
  229.                    q w e r t y u i o p
  230.                                                                                   @A0
  231.     These are the keys you can use for playing the instruments. If you
  232.     don't want the module to disturb your fine music, press Alt-p to
  233.     pause the module. If you open several extra channels, you can play
  234.     several voices simultaneously, with ANY soundcard supported! This
  235.     might be some fun. You can also save the samples to disk with
  236.     Alt-S(ave) function. Morgul will ask you a filename and then save
  237.     the sample into raw 8-bit mono format, or in the Scream Tracker 3
  238.     instrument format, whichever you choose, with the sampling frequency
  239.     varying (it will tell you what it is, when saving.)
  240.  
  241.     Pressing TAB again gets you back to the normal "file" mode.
  242.  
  243.     Please note that even if you're not in the file screen or in the
  244.     instrument screen, you can still use all the keys. So you can press
  245.     Enter anywhere to go to the next module, or play the instruments
  246.     while looking at the files or the helpscreen.
  247.  
  248.                         Drum Machine Mode                                         @F0
  249.                                                                                   @A0
  250.     Pressing CTRL-D brings you into the drum machine mode. In this mode,
  251.     if a module is loaded, you can play different samples without first
  252.     selecting them by pressing the keys from 1 to 0 and from a to z. The
  253.     instrument will play at it's base frequency. This mode is especially
  254.     meant for trying out drum instruments in a module.
  255.  
  256.                         The track screen                                          @F0
  257.                                                                                   @A0
  258.     Pressing Alt-T will activate the track screen which shows the notes,
  259.     their octaves and samples go by on the channels as they are played.
  260.     The track screen will replace the volume bar screen. The tracks are
  261.     made of 6-character fields, looking like this:
  262.  
  263.     E-3-01                                                                        @F0
  264.     │ │ ││
  265.     │ │ │└──────────── The number of the instrument
  266.     │ │ └───────────── which is currently being played.
  267.     │ │
  268.     │ └─────────────── The octave of the note
  269.     └───────────────── The note, and whether or not it is #'ed.
  270.                                                                                   @A0
  271.     Press Alt-T to deactivate the track screen and get the volume bars
  272.     back. Note that if you hit alt-t twice, the whole screen will be
  273.     redrawn. Use it if the screen gets messed up by something.
  274.  
  275.                         The graphics mode                                         @F0
  276.                                                                                   @A0
  277.     This is yet very unfinished and has no fancy features. It's there
  278.     because it only took some 5 minutes to implement it. It will be
  279.     enhanced in the future. Stuff like flames and fractal backgrounds
  280.     are planned.
  281.  
  282.                          The Help Screen                                          @F0
  283.                                                                                   @A0
  284.     Screen number 3 (the bottom one) is the help screen, accessible via
  285.     either Page Down or Alt-3. There's nothing to do here except look at
  286.     the instructions. It is very recommended to do so! There are many
  287.     things that you would miss otherwise. Pressing Alt-H will give you
  288.     this documentation if it's in the current directory or in the path.
  289.     If not, it will simply give you the help screen. Pressing Alt-M will
  290.     give you a menu where you can choose commands.
  291.  
  292.                            Dos Shell                                              @F0
  293.                                                                                   @A0
  294.     While in Dos Shell you can change the volume of the music with Alt-
  295.     and Alt+ (on the numeric keypad) and skip patterns with Ctrl+/Ctrl-
  296.     on the numeric keypad.
  297.  
  298.                           File copying                                            @F0
  299.                                                                                   @A0
  300.     If you have no tagged files, pressing Alt-C will copy the file under
  301.     the cursor to the specified location. If you have tagged files, all
  302.     tagged files will be copied to the location. If you specify a drive
  303.     or a directory or drive+directory, the file(s) will be copied there,
  304.     if you specify [drive+][directory+]filename, the file(s) will be
  305.     copied to that filename.
  306.     If you have no tagged files and you are on the "." directory, all
  307.     files in the directory will be copied.
  308.  
  309.     To allow flexible pathname handling, your command processor is
  310.     executed to do the actual copying. Morgul uses the COMSPEC
  311.     environment variable so users of 4Dos and other command.com
  312.     replacements will have no trouble at all.
  313.  
  314.                             Configuration file                                    @F0
  315.                                                                                   @A0
  316.     You can change the default settings by putting the appropriate
  317.     switches into a SET MORGUL=switches statement in your autoexec.bat,
  318.     but you can also use the Morgul.cfg configuration file. Use any
  319.     ascii editor to change the values in there, and keep the file either
  320.     in your path or in the directory you start Morgul from.
  321.     The configuration file options are explained in detail in the config
  322.     file itself.
  323.  
  324.                             Digital Effects                                       @F0
  325.                                                                                   @A0
  326.     By pressing Alt-F, you can choose a Digital Effect to enhance your
  327.     sound enjoyment! The effects are defined in morgul.cfg and you need
  328.     the file if you want to have the digital effects.
  329.  
  330.                 List of all available keys and commands                           @Z5Commands
  331.                                                                                   @A0
  332. ░░░┌───The─Morgul─Help─Screen───────────────────────────────────────────────┐░░░  @F9
  333. ░░░│ Available keys:                                                        │░░░
  334. ░░░│ Alt-M    Menu                         F1           Save directory      │░░░
  335. ░░░│ Alt-P    Pause module                 CTRL-P       Panning setup screen│░░░
  336. ░░░│ Alt-J    Shell to Dos                 PgUp/Pgdn    Scroll the files    │░░░
  337. ░░░│ Alt-V    Toggle 80x56 mode            CTRL-PgUp/Dn Scroll the screen   │░░░
  338. ░░░│ Alt-D    Delete current file          CTRL-V       Change Master Volume│░░░
  339. ░░░│ Alt-H    ONLINE DOCS                  ^R,^G,^B     Change box color    │░░░
  340. ░░░│ Alt-T    Track screen                 Alt-1,2,3,4  Change active screen│░░░
  341. ░░░│ Alt-S    Instrument saving            Tab          Switch between Instr│░░░
  342. ░░░│ Alt-R    Toggle Random order                       /File Mode          │░░░
  343. ░░░│ Alt-E    Toggle Easy filemode         Ctrl-Left/   Increase/Decrease   │░░░
  344. ░░░│ Alt-G    Graphical mode               Ctrl-Right   channel amount      │░░░
  345. ░░░│ Alt-C    Copy files                   ESC          Exit                │░░░
  346. ░░░│ Alt-F    Digital Effects              Q...P        Play instruments    │░░░
  347. ░░░│ Insert   Tag ALL files                Arrows       Move in instrument  │░░░
  348. ░░░│ Delete   UnTag ALL files                           or file list        │░░░
  349. ░░░│ Space    In File mode TAG module      Home/End     Go to beginning /end│░░░
  350. ░░░│ N        Go to next tagged                         of file/instr. list │░░░
  351. ░░░│          module and play it                                            │░░░
  352. ░░░└────────────────────────────────────────────────────────────────────────┘░░░
  353.                                                                                   @A0
  354.                         Command line parameters
  355.  
  356. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  @F9
  357. ░░░┌───Available─command─line/environment─set─options─for─Morgul────────────┐░░░
  358. ░░░│                                                                        │░░░
  359. ░░░│   -r    Select startup screen 1,2,3  -c    Select sound device         │░░░
  360. ░░░│   -o    Select Random mode           -d    Select sound card DMA chan  │░░░
  361. ░░░│   -n    Set default panning          -i    Select scard interrupt      │░░░
  362. ░░░│   -v    Set 80x56 mode               -p    Select scard port           │░░░
  363. ░░░│   -a    Select Amplify rate          -t    Select DMA buffer size      │░░░
  364. ░░░│   -j    Select bar color (0,1,2)     -g    Disable Gus DMA usage       │░░░
  365. ░░░│   -l    Enable keyboard lights       -b    Disable use of EMS memory   │░░░
  366. ░░░│   -fxx  Select digital effect xx     -s    Select sample rate          │░░░
  367. ░░░│   Available sound device numbers:                                      │░░░
  368. ░░░│   1=SB,2=SB Pro,3=PAS+,4=PAS16,5=SB16,6=DAC,7=Aria,8=Windows Sound     │░░░
  369. ░░░│   System/AudioTrix/BusinessAudio,9=Gravis Ultrasound,10=Speaker,       │░░░
  370. ░░░│   11/12=Stereo DAC                                                     │░░░
  371. ░░░│   These options can be used from the command line and also by          │░░░
  372. ░░░│   adding the line Set Morgul=options in your Autoexec.bat file.        │░░░
  373. ░░░│                                                                        │░░░
  374. ░░░└────────────────────────────────────────────────────────────────────────┘░░░
  375.                                                                                   @A0
  376.                         The file screen explained
  377.  
  378. ░ The Morgul 1.00 by Toni Nikkanen 1994.  DSMI (C)  Otto Chrons 1992-1994.    ░░  @F9
  379. ░ Press CTRL-Pgup for the module screen,CTRL-Pgdn for help or Alt-M for menu  ░░
  380. ░░░┌────────────────────────────────────────────────────────────────────────┐░░░
  381. ░░▓│ Filesize: 25kb   Patterns: 21   Samples: 5    Files tagged: 1          │░░░
  382. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  383. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  384. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  385. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  386. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  387. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  388. ░░▓│.            │A directory                       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  389. ░░▓│..           │A directory                       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  390. ░░▓│MODULE.MOD   │And here's it's description       │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  391. ░░▓│2ND_SKAV.S3M │Here's another module file        │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  392. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  393. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  394. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  395. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  396. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  397. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  398. ░░▓│             │                                  │ ■■■■■■■■■■■■■■■■■■■■  │░░░
  399. ░░▓└Directory: E:\MODULE────────────────────────────────────────────────────┘░░░
  400. ░░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░░
  401. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  402. ░░                                                                           ░░░
  403. ░░                                                                           ░░░
  404. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  405.                                                                                   @A0
  406.     The file size means the size of the current file in kilobytes,
  407.     patterns means the amount of patterns (the length) of the file,
  408.     samples means how many samples (instruments) there are in it, and
  409.     Files tagged means how many files you have tagged.
  410.  
  411.     The first column is where the file names will be. In this example
  412.     file there are MODULE.MOD and 2ND_SKAV.S3M. In the next column is
  413.     the module's song name. The next one (with ■■ characters) is
  414.     graphical display of the file's size. At the lowermost part of the
  415.     screen is a volume bar just for fun. The current directory is shown
  416.     just below the file names.
  417.  
  418.     If a module with a description like "Inside MODULE.ARJ" or "Inside
  419.     MODULE.ZIP" or so on appears, it means it is inside an archive. You
  420.     can play these just like normal modules, the unarchiver will be
  421.     called automatically.  Note that Morgul is capable of using the
  422.     unarchivers if they are specified as BAT/BTM files or even aliases.
  423.  
  424.                 Tested software and hardware configurations:                      @Z3Tested s/hware
  425.                                                                                   @A0
  426.  
  427.     MS-Dos 2.11 (YES!), MS-Dos 5.00, Ms-Dos 6.00, Ms-Dos 6.20, Dr Dos
  428.     6.0, PC-Dos 5.0, Novell Dos 7.
  429.  
  430.     It seems that Morgul won't work with OS/2 releases up to 2.11,
  431.     because DSMI uses DMA features which are not supported under OS/2.
  432.     If a cure is found, I will of course inform you of it.
  433.  
  434.     Quarterdeck DESQview 2.60 & 2.61  (works perfect except that
  435.     although you CAN scroll and switch screens, DESQview doesn't know it
  436.     so you don't ever see anything beyond the first screen. I am working
  437.     to find a way around this. To get any sense out of Morgul while in
  438.     DESQview, start Morgul with -r1). Morgul can release time slices
  439.     under DESQview.
  440.  
  441.     It is possible to make Morgul work under Windows. Under some
  442.     configurations it will work, and under others it won't. Try and see
  443.     what happens, and send me info about what happened. Warning: Windows
  444.     might very well crash. Windows time slice releasing is also supported.
  445.  
  446.     Quarterdeck QEMM, Microsoft EMM386, Qualitas 386^Max (works perfect,
  447.     but on slow computers the Covox/Speaker support might hang the
  448.     computer because these protected mode programs slow interrupts. They
  449.     also decrease sound quality with Covox/Speaker devices.)
  450.  
  451.     Novell EMM386: In DOS Shell the music might slow down strangely. If
  452.     you disable EMM386 or change to another memory manager, the problem
  453.     disappears.
  454.  
  455.     UMB_DRVR 5.22: works perfectly, except for UMB_EMS4.SYS
  456.     DON'T use Qemm's Vidram, it prevents Morgul from using 80x28 text
  457.     mode.
  458.     Helix Software NetRoom 3.02 (Works, and the Stretch utility, similar
  459.     to Vidram, works perfectly, unlike Vidram.)
  460.  
  461.     Linux Dosemu 0.52pl0: Works, if you have vga console graphics set
  462.     on, but cannot play anything. I believe it is currently impossible
  463.     to use sound boards in dosemu.
  464.  
  465.     Somebody could try this under Windows NT, NeXTStep/486, Solaris,
  466.     InterActive Unix, SCO Unix and the rest, and tell me about the
  467.     results. Also it would be fun to know whether or not it runs on
  468.     PowerMacintosh dos emulation, and AlphaPC-WindowsNT Dos emulation.
  469.  
  470.  
  471.  
  472.  
  473. contact information:                                                              @Z6Contact
  474. Product:         Morgul 1.00                                                      @B0
  475. Author:          Toni Nikkanen
  476. Address:         Kymenlaaksonkatu 9 D 47
  477.                  SF-48100 Kotka
  478.                  Finland, Europe
  479. Voice:           +358 52 15817
  480. e-mail:          tnikkane@clinet.fi, if it fails, try toni@valhall.nullnet.fi
  481. Fidonet netmail: 2:221/18   Note! This was previously 2:227/18 !!
  482. BBS:             Valhalla Linux, leave message to account toni.
  483.                  Hangar BBBS, leave message to Toni Nikkanen in the
  484.                  Posti conference.
  485.  
  486.  
  487.                      Credits and interesting info:                                @Z7Credits
  488.                                                                                   @A0
  489.     The module playing routines are part of the Digital Sound and Music
  490.     Interface library by Otto Chrons 1992-1994. Everything else is
  491.     written by me with Borland C++ 3.1, using C language and a few
  492.     pieces of assembler. The editor used was Multi-Edit V7.00PN from
  493.     American Cybernetics. This editor is, by the way, highly recommended
  494.     and beats even the Semware Editor.
  495.  
  496.     Thanks go out for the following:
  497.                                                                                   @F0
  498.     Otto Chrons             for making DSMI
  499.     Pietu Pohjalainen,
  500.     Rauli Priha,
  501.     Juha Niemi,
  502.     Teemu Koponen           for making me buy DSMI
  503.     Robert K Jung           for very good ARJ documentation and support
  504.     Nico de Vries/AIP-NL    for very good UC2 support and documentation
  505.     Kari Tuomainen          for helping with some messy Pascal sources and
  506.                             several other things
  507.     Brad Meier              for competing with my DMPS with his DMPC
  508.                             (keep on going; don't stop now! Where's your
  509.                             registration card, huh?)
  510.     Petri Harkko,
  511.     Tomi Pahula,
  512.     Olli Männistö,
  513.     Jari Turkia             for finding lots of bugs
  514.     Skaven/FC, PM/FC,
  515.     C.C.Catch/Ren,Heatbeat,
  516.     Moby,HMW, and others    for making lots of wonderful modules to test
  517.                             Morgul Player with.
  518.     J.M.Jarre               for making lots of wonderful music which I could
  519.                             listen to while coding Morgul
  520.     J.R.R. Tolkien          for inventing the name of Morgul Player
  521.  
  522.  
  523.                                 History
  524.                                 -------                                           @A0
  525.     I started making the DMP Shell program (DMP (C) 1992-1994 Otto
  526.     Chrons, NOT ME!) when I got tired of the lack of a reasonable
  527.     interface in the otherwise very good player program. The DMP Shell
  528.     turned out to be quite successful, and while I was attending the
  529.     Assembly '93 meeting, there was a special discount price for DSMI,
  530.     and since my friends pressured me to buy it, I bought it. That's the
  531.     reason I'm now making this program.
  532.  
  533.                             Distribution policy                                   @Z8Policy
  534.                             -------------------                                   @A0
  535.  
  536.     Morgul is freeware, with a few restrictions. The distributable
  537.     version is in no way crippled and it is fully functional. If you use
  538.     this program for more than 7 days, there are two kinds of
  539.     registration:
  540.  
  541.     The lighter one, which involves sending me a postcard (YES, a
  542.     snail-mail POSTCARD, please no letters, and e-mail is nice but it's
  543.     not a postcard, so it doesn't count) from your homeland telling who
  544.     you are, where you are, what you are and what you think of this
  545.     program.
  546.  
  547.     The better one is sending me $5 or 20 FIM (equivalent amounts in
  548.     other currencies are accepted), this will get you the next MAJOR
  549.     update via post on a 3.5" HD diskette (I can also send on a 5.25" HD
  550.     diskette, but I can't quarantee it will be okay when it arrives),
  551.     and it will say it's registered to your name. I will also fill the
  552.     disk with good module files so if it's hard for you to get updates
  553.     or modules (you don't have a modem/inet access), this is the way to
  554.     go.
  555.  
  556.     And when I mean MAJOR update, I mean that. So you don't get the NEXT
  557.     new version if it's not a major enough update. Please specify what
  558.     version you were using at that time.
  559.  
  560.     You really don't have to send ANY money; a postcard is enough, but
  561.     since I've had some trouble writing this program I'd really
  562.     appreciate some monetary thing, but YOU DON'T EVER HAVE TO PAY, if
  563.     you don't want to. So Morgul is actually NOT shareware as we know
  564.     it. (So there, I avoid DSMI license restrictions quite sneakily!)
  565.  
  566.